home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_1 / atbl / atbl.doc < prev    next >
Text File  |  1992-10-31  |  12KB  |  331 lines
  1.                ATbl - Manuel de l'utilisateur
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8. 1. Avertissement
  9.  
  10.     Ce manuel décrit la version 2.30 de l'utilitaire ATbl. Ce  programme
  11. est (c)1991-1992 par Denis GOUNELLE, toute utilisation commerciale ou  vente
  12. sans autorisation écrite est strictement interdite. Vous  pouvez  copier  et
  13. diffuser ce programme aux conditions suivantes :
  14.  
  15.       - l'ensemble des fichiers doit être fourni
  16.       - aucun fichier ne doit avoir été modifié
  17.       - vous ne devez pas demander plus de 40FF pour cela
  18.  
  19.     Malgré de nombreux tests, je ne peux garantir  qu'ATbl  ne  contient
  20. aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS RISQUES  ET  PERILS.  Je  ne
  21. pourrai en aucun cas être  tenu  responsable  de  tout    dommage,  direct  ou
  22. indirect, résultant de l'utilisation d'ATbl.
  23.  
  24.  
  25. 2. Introduction
  26.  
  27.     ATbl est un programme destiné à permettre la création  de  tableaux.
  28. Il offre trois modes de sortie :
  29.  
  30.     TXT  (mode texte) très laid, mais peut être utile  pour  une
  31.          pré-visualisation ou un test.
  32.     PRT  (mode impression)  résultat  nettement  meilleur,  mais
  33.          votre  imprimante    doit  être  capable  d'imprimer  les
  34.          caractères semi-graphiques IBM.
  35.     IFF  (mode IFF) le meilleur résultat. Vous  pouvez  utiliser
  36.          n'importe   quelle   police   de    caractères    (même
  37.          proportionelle) et choisir la couleur de fond ainsi que
  38.          la couleur d'écriture. Les croisements entre les lignes
  39.          verticales et  horizontales  sont    optimisés  le  mieux
  40.          possible. Le  résultat  est  produit  sous  forme    d'un
  41.          fichier IFF qui peut ensuite être chargé par  n'importe
  42.          quel programme de traitement de texte ou de PAO.
  43.  
  44.     ATbl s'inspire de l'utilitaire "tbl" que l'on trouve  habituellement
  45. sous système UNIX, et d'autres travaux que Guillaume GIROD et moi-même avons
  46. fait. Mon but était de rendre la création de tableaux aussi  simple  que  de
  47. taper les données à mettre dans le tableau. Cela est vrai pour les modes TXT
  48. et IFF, mais pour le  mode  PRT  il  vous  faudra  indiquer  au  moins    deux
  49. paramêtres.
  50.  
  51.     Vous pouvez me faire part de vos remarques ou critiques sur ATbl, en
  52. écrivant à l'adresse suivante:
  53.  
  54.                  M. GOUNELLE Denis
  55.                   Boite 71
  56.                 6, rue des cailloux
  57.                92110 CLICHY - FRANCE
  58.  
  59.     La génération du fichier IFF a été réalisée à  partir  du  programme
  60. "ScreenSaver" parut dans "Amiga News Tech" numéro 24 (juillet/aout 1991).
  61.     En France, la dernière version de ce programme est disponible auprès
  62. de Serge HAMMOUCHE, 3 rue Anatole France,  13220  Chateauneuf-les-Martigues.
  63. Pour recevoir le catalogue complet, il vous suffit d'envoyer deux timbres  à
  64. cette adresse.
  65.  
  66.  
  67. 3. Une démo rapide
  68.  
  69.     Appelez votre éditeur de texte favori, et tapez quelques  lignes  de
  70. données, comme par exemple :
  71.  
  72.         Slayer <tab> Seasons In The Abyss <tab> 1990
  73.         <tab> South of Heaven <tab> 1988
  74.         Iron Maiden <tab> Fear Of The Dark <tab> 1992
  75.         <tab> Somewhere In Time <tab> 1986
  76.         Anthrax <tab> Persistence Of Time <tab> 1990
  77.         Coroner <tab> Mental Vortex <tab> 1991
  78.  
  79. La notation <tab> désigne un  caractère  de  tabulation.  Si  votre  éditeur
  80. remplace les tabulations par des espaces, utilisez plutôt un "/", et ajoutez
  81. la ligne ".tc /" au début du fichier.
  82.     Sauvegardez ce fichier. Lancez ATbl depuis le CLI, en  tapant  "ATbl
  83. <le nom de votre fichier> TXT". Vous obtiendrez alors :
  84.  
  85.         +-----------+--------------------+----+
  86.         |   Slayer  |Seasons In The Abyss|1990|
  87.         |        |      Hell Awaits     |1985|
  88.         |Iron Maiden|  Fear Of The Dark  |1992|
  89.         |        |  Somewhere In Time |1986|
  90.         |  Anthrax  | Persistence Of Time|1990|
  91.         |  Coroner  |     Mental Vortex     |1991|
  92.         +-----------+--------------------+----+
  93.  
  94. Retournez sous votre éditeur, et ajoutez la ligne  ".ad  llc"  au  début  du
  95. fichier. Sauvez le, et appelez ATbl à nouveau. Le résultat est    maintenant :
  96.  
  97.         +-----------+--------------------+----+
  98.         |Slayer     |Seasons In The Abyss|1990|
  99.         |        |Hell Awaits     |1985|
  100.         |Iron Maiden|Fear Of The Dark     |1992|
  101.         |        |Somewhere In Time     |1986|
  102.         |Anthrax    |Persistence Of Time |1990|
  103.         |Coroner    |Mental Vortex     |1991|
  104.         +-----------+--------------------+----+
  105.  
  106. Dernière manipulation : depuis votre éditeur, ajoutez les  lignes  suivantes
  107. au début du fichier.
  108.  
  109.         .ad css
  110.         Très bons albums
  111.         .nl
  112.  
  113. Sauvegardez le fichier, et appelez ATbl. Voici le résultat :
  114.  
  115.         +-----------+--------------------+----+
  116.         |        Très bons albums          |
  117.         +-----------+--------------------+----+
  118.         |Slayer     |Seasons In The Abyss|1990|
  119.         |        |Hell Awaits     |1985|
  120.         |Iron Maiden|Fear Of The Dark     |1992|
  121.         |        |Somewhere In Time     |1986|
  122.         |Anthrax    |Persistence Of Time |1990|
  123.         |Coroner    |Mental Vortex     |1991|
  124.         +-----------+--------------------+----+
  125.  
  126.  
  127. 4. Manuel
  128.  
  129.     La syntaxe d'appel de ATbl est la suivante :
  130.  
  131.              ATbl entrée {TXT|PRT|IFF} [sortie]
  132.  
  133. Le fichier "entrée" est le fichier à traiter pour produire  un  tableau.  Le
  134. second    argument  indique  le  mode  de  sortie.  Le  fichier  "sortie"  est
  135. facultatif : s'il n'est pas indiqué, la sortie ira sur la sortie standard en
  136. mode TXT et vers l'imprimante en mode PRT, mais en mode IFF aucun fichier ne
  137. sera produit.
  138.  
  139.     Le fichier d'entrée contient à la fois vos données et les paramêtres
  140. de formatage du tableau. Les données sont un ensemble  de  lignes,  avec  le
  141. texte  de  chaque  colonne  séparé  par  une  tabulation  (ce  caractère  de
  142. séparation peut être changé). Les  lignes  verticales  sont  automatiquement
  143. tracées  entre    chaque    colonne.  Les  paramêtres  sont  indiqués  par     des
  144. "requêtes" : ils doivent être placés sur des lignes à part,  commençant  par
  145. un point.
  146.     Voici la liste des requêtes. La chaine entre crochets après  le  nom
  147. des requêtes a la signification suivante :
  148.  
  149.     *    ne peut être utilisée qu'AVANT les lignes de données
  150.     T    utilisée seulement en mode TXT
  151.     P    utilisée seulement en mode PRT
  152.     I    utilisée seulement en mode IFF
  153.  
  154.  
  155. ad  ADjust
  156.     Syntaxe    : ad str
  157.     Description : indique l'ajustement du texte dans  les  colonnes.  Chaque
  158.     caractère de "str" s'applique  à  la  colonne  correspondante,  et  peut
  159.     être :
  160.  
  161.         l        cadré à gauche
  162.         r        cadré à droite
  163.         c        centré
  164.         s        continuation de la colonne précédente
  165.  
  166. an  Auto-Newline
  167.     Syntaxe    : an {0|1}
  168.     Description : active (1) ou  désactive  (0)  la  génération  automatique
  169.     d'une requête ".nl" après chaque ligne de texte
  170.  
  171. as  After String [*P]
  172.     Syntaxe    : as str
  173.     Description : indique la séquence à  envoyer  à  votre  imprimante    pour
  174.     revenir en mode "Amiga". "str" est une suite de codes décimaux,  séparés
  175.     par des espaces.
  176.  
  177. bp  Back Pen [*I]
  178.     Syntaxe    : bp n
  179.     Description : indique la couleur de fond ("n" est un numéro de  registre
  180.     de couleur).
  181.  
  182. bs  Before String [*P]
  183.     Syntaxe    : bs str
  184.     Description : indique la séquence à  envoyer  à  votre  imprimante    pour
  185.     passer en mode "IBM". "str" est une suite de codes décimaux, séparés par
  186.     des espaces.
  187.  
  188. cw  Column Width [*]
  189.     Syntaxe    : cw n m
  190.     Description : force la largeur de la colonne "n" à  "m"  caractères  (ou
  191.     pixels en mode IFF).
  192.  
  193. fp  Front Pen [*I]
  194.     Syntaxe    : fp n
  195.     Description : indique la  couleur  d'écriture  ("n"  est  un  numéro  de
  196.     registre de couleur).
  197.  
  198. ft  FonT [*I]
  199.     Syntaxe    : ft name size
  200.     Description : indique la police à utiliser pour le texte.
  201.  
  202. hl  Horizontal Line
  203.     Syntaxe    : hl car [col]
  204.     Description : indique l'aspect des  lignes  horizontales.  Le  caractère
  205.     "car" peut être :
  206.  
  207.         b        pas de ligne
  208.         -        trait simple
  209.         =        trait double
  210.  
  211.     L'argument "col" (facultatif) est une  suite  de  numéros  de  colonnes,
  212.     séparés par des virgules.  S'il  est  omis,  toutes  les  colonnes  sont
  213.     concernées.
  214.  
  215. lm  Left Margin [*]
  216.     Syntaxe    : lm n
  217.     Description : ajoute une marge gauche de "n" caractères  (ou  pixels  en
  218.     mode IFF).
  219.  
  220. nl  New Line
  221.     Syntaxe    : nl
  222.     Description : trace une ligne horizontale.
  223.  
  224. np  Number of Planes [*I]
  225.     Syntaxe    : np n
  226.     Description : indique le nombre de plans à utiliser pour l'écran.
  227.  
  228. ph  Page Height [*I]
  229.     Syntaxe    : ph n
  230.     Description : indique la hauteur de la page (en pixels).
  231.  
  232. pw  Page Width [*I]
  233.     Syntaxe    : pw n
  234.     Description : indique la largeur de la page (en pixels).
  235.  
  236. tc  Tab Character
  237.     Syntaxe    : tc [car]
  238.     Description : change le caractère séparateur de colonnes. Si  "car"  est
  239.     omis, la valeur par défaut (tab) est reprise.
  240.  
  241. tp  Text Pen [I]
  242.     Syntaxe    : tp n [col]
  243.     Description : indique la couleur à utiliser pour le texte  ("n"  est  un
  244.     numéro de registre de couleur). L'argument "col"  (facultatif)  est  une
  245.     suite de numéros de colonnes, séparés par des virgules. S'il  est  omis,
  246.     toutes les colonnes sont concernées. Notez que la requête  "fp"  modifie
  247.     la couleur de toutes les colonnes.
  248.  
  249. vl  Vertical Line
  250.     Syntaxe    : vl car [col]
  251.     Description : indique l'aspect des lignes verticales. Le caractère "car"
  252.     peut être :
  253.  
  254.         b        pas de ligne
  255.         |        trait simple
  256.         #        trait double
  257.  
  258.     L'argument "col" (facultatif) est une  suite  de  numéros  de  colonnes,
  259.     séparés par des virgules.  S'il  est  omis,  toutes  les  colonnes  sont
  260.     concernées. La colonne 0 est la marge gauche.
  261.  
  262. xx  comment
  263.     Syntaxe    : xx str
  264.     Description : ligne commentaire.
  265.  
  266.  
  267. 5. Le mode IFF
  268.  
  269.     Quand vous demandez le mode IFF, ATbl ouvre un écran dont la  taille
  270. est soit celle indiquée par les requêtes  ".pw"  et  ".ph",  soit  celle  de
  271. l'écran Workbench. Le nombre de plans (et donc de  couleurs)  de  cet  écran
  272. peut être modifié par la requête ".np". Par défaut, il n'y a qu'un plan : le
  273. tableau est donc tracé en couleur 0 sur fond de couleur 1. Les    couleurs  de
  274. tracé et de fond peuvent être modifiées par les  requêtes  ".tp",  ".fp"  et
  275. ".bp".
  276.     Le pointeur souris devient une bulle "Zz", pendant  que  le  tableau
  277. est affiché puis que le fichier IFF est généré. Appuyez sur le bouton gauche
  278. de la souris pour obtenir la page suivante  (si  elle  existe),  ou  sur  le
  279. bouton droit pour quitter.
  280.  
  281.  
  282. 6. Appel depuis le Workbench
  283.  
  284.     ATbl peut être appelé depuis le Workbench. Le  mode  de  sortie  est
  285. alors obligatoirement le mode IFF, et aucun fichier n'est généré.  En  fait,
  286. cette possibilité n'a été ajoutée que pour  permettre  la  visualisation  de
  287. tableau directement depuis le Workbench. Il vous suffit pour cela  de  créer
  288. une icône de type "Project" pour votre  fichier  source,  et  de  mettre  le
  289. chemin d'accès à ATbl dans le champ "Default Tool".
  290.  
  291.  
  292. 7. Historique
  293.  
  294. v1.00    16-Nov-91, 14864 octets (Fish #583)
  295.     o Première version diffusée.
  296.  
  297. v2.00    24-Aug-92, 19324 octets
  298.     o Recompilé avec le SAS/C 5.10b (avec pragmas et optimisation)
  299.     o N'a plus besoin de la "iff.library"
  300.     o De nombreux bugs corrigés (plus  de  problèmes  avec  Enforcer  ni
  301.     Mungwall)
  302.  
  303. v2.10    07-Sep-92, 20760 octets
  304.     o Peut être appelé depuis le Workbench
  305.     o Ajout des requêtes ".an" et ".tp"
  306.  
  307. v2.20    22-Sep-92, 21460 octets
  308.     o Les requêtes ".ph" et ".pw" ne sont plus obligatoires en mode  IFF
  309.     (va chercher les valeurs par défaut dans la structure GfxBase)
  310.     o En mode PRT, si le fichier de sortie n'est pas précisé, le tableau
  311.     est envoyé vers l'imprimante
  312.     o Affiche  la  syntaxe    d'appel  si  pas  d'arguments  ou   en   cas
  313.     d'arguments incorrects
  314.     o Police   "atbl.font"   intégrée   dans   l'exécutable   grâce    à
  315.     "FontConverter" (c)1992 par Andreas Baum.
  316.  
  317. v2.30    26-Sep-92, 21816 octets
  318.     o Gestion de l'ajustement 's' corrigé  (calcul  de  la  largeur  des
  319.     colonnes maintenant exact)
  320.     o Gestion des messages Intuition revue (ne  réagit  qu'à  MENUUP  et
  321.     SELECTUP)
  322.  
  323. v2.31    30-Sep-92, 21844 octets
  324.     Bug corrigé dans l'accès aux listes (à deux endroits,  ne  vérifiait
  325.     pas qu'un pointeur était valide)
  326.  
  327.  
  328.  
  329.  
  330.  
  331.